home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / pcf2qb3.arc / PCF2QB3.DOC next >
Text File  |  1988-01-17  |  5KB  |  136 lines
  1.  
  2.  
  3.  
  4.  
  5.                              PCF2QB3
  6.  
  7.  
  8.                   A Program Generation Utility
  9.  
  10.                                for
  11.  
  12.                        PC-File+ Data Bases
  13.  
  14.  
  15.  
  16.  
  17.                         Copyright 1988 by
  18.                Integrated Financial Systems, Inc.
  19.                       201 East Main Street
  20.                       Louisville, KY 40202
  21.                          (502) 583-8976
  22.  
  23.                        ALL RIGHTS RESERVED
  24.  
  25.                 PC-FILE to QuickBASIC Generator
  26.  
  27. Background:
  28.  
  29.      Integrated Financial Systems, Inc. (IFS) is a commercial
  30. custom program development firm with offices in Louisville, Ky.
  31. For several years we have had occasion to assist our clients with
  32. conversions, specialized reports, and other such activities using
  33. PC-File. We have strongly supported ButtonWare products as an
  34. entry level data base. However, with even the best of products
  35. our clients have a knack for finding a need for a report or
  36. process which requires custom programming. With PC-File III, PC-
  37. FILE/R, and now even with PC-File+, we have continually had to
  38. resort to custom programming.
  39.  
  40.      Eventually, we grew tired of hand coding data file layouts,
  41. particularly error-prone coding of BASIC FIELD statements. Thus,
  42. PCF2QB3 was born. 
  43.  
  44.  
  45. General Description:
  46.  
  47.      PCF2QB3, the version of the utility included in this
  48. package, is an automatic program source code generator for
  49. QuickBasic versions 3.0 and 4.0. It has the "QB3" suffix because
  50. it does not take advantage of the new record TYPE structures
  51. available with QB4. It does generate fairly clean code for both
  52. versions.
  53.  
  54.      The program reads the ".HDR" file of a PC-File+ data base
  55. and generates a clean, compilable QuickBasic program with all
  56. FIELD statements and a sequential processing mainline process. It
  57. even performs a conversion of all data field names ending with
  58. "#" to a basic double precision variable automatically.
  59.  
  60.      From that point on it's up to you to add any special
  61. processing required.  We use the program most often for complex
  62. reports requiring many levels of subtotaling, as well as using
  63. PC-File+ data bases for table storage of data for complex
  64. processing algorithms.
  65.  
  66. USAGE:
  67.  
  68.      PCF2QB3 usage could not be simpler, we don't think. Type
  69. PCF2QB3, and you will be prompted for the name (and, optionally
  70. the drive and path) of a PC-FILE+ data base. After a few seconds,
  71. you will be prompted for a name for the BASIC program which you
  72. wish to create. DO NOT ADD AN EXTENSION to this name. The program
  73. will automatically be generated with an extension of ".BAS".
  74.  
  75.      PCF2QB3 will save any file which may currently exist by the
  76. name you selected to "name.OLD" (where "name" is the existing
  77. file name).  This was quickly added on day when a 1200 line
  78. program was replaced by a newly generated .BAS file.
  79.  
  80. USING THE GENERATED PROGRAM:
  81.  
  82.      If you can't follow the generated program logic, you
  83. PROBABLY shouldn't be using it. However, we do recommend that you
  84. use the data variable name generated in the CnvrtDta procedure
  85. rather than the FIELD statement data names. 
  86.  
  87.      Also, note that PC-FILE+ is much more liberal with data
  88. field names than is BASIC. PCF2QB3 strips out all special
  89. characters, such as the underscore character, as part of the
  90. generate process. This will cause problems only if you are using
  91. field names which differ only by a special character (which is
  92. bad practice anyway). THIS IS A DIFFICULT BUG TO CATCH in BASIC,
  93. so review the generated names carefully before using the new
  94. source code. Finally, PCF2QB3 does not check for the use of reserved
  95. BASIC words as PCFILE field names. Change any conflicts before 
  96. compiling.
  97.  
  98.      The generated program is designed for sequential
  99. processing, but can be easily converted to indexed access. We
  100. often add logic to write back into the data base as well. Most
  101. often this is done in a batch mode followed by a PCFIX run to
  102. rebuild the index.
  103.  
  104.  
  105. THE CATCH:
  106.  
  107.      No catch. Use PCF2QB3 any way you want. We assume that
  108. commercial use is the primary target of developers, so generate
  109. away.  If you want the source code, just send us a request and
  110. $25. You will get the source for PCF2QB3 and PCF2QB4, which is a
  111. much faster version, by return mail. The QB4 product generates
  112. record TYPE structures rather than FIELD statements. Once you use
  113. it, you will never go back.
  114.  
  115.  
  116. DISCLAIMER:
  117.  
  118.      Use the product at your own risk. We do, and so far we're
  119. all still healthy and productive members of society. 
  120.  
  121.      Also, PC-FILE, PC-FILE III, PC-FILE/R, and PC-FILE+ are
  122. trademarks of Buttonware, Inc.  QuickBasic 3.0, and 4.0 are
  123. trademarks of Microsoft Corporation.
  124.  
  125.      (IFS doesn't have trademarks yet, because we're too busy.
  126. Maybe someday....)  What we DO have is a very sophisticated and
  127. simple to use report generator for Armor System's EXCALIBUR PLUS
  128. Accounting package, a FoodBank Management System for non-profit
  129. agencies, and a wide variety of DataFlex application packages and
  130. programming support utilities. Call for details if interested.
  131.  
  132. Integrated Financial Systems, Inc.
  133. 201 East Main Street
  134. Louisville, KY 40202
  135. (502) 583-8976   CompuServe ID: 74676,1103 
  136.